home *** CD-ROM | disk | FTP | other *** search
/ Windows 95 Super Collection / Windows 95 Super Collection.iso / win95 / programm / mdf150 / mdf_esp.txt < prev    next >
Encoding:
Text File  |  1995-11-12  |  17.4 KB  |  441 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Versión  1.50
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.         Un programa simple pero completo para producir y aplicar patches a
  24.         programas y archivos de datos para DOS, OS/2, Windows 95 y Windows NT.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                               Manual en idioma español.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.               (C) 1995/96 Maurizio Giunti - Todos los derechos reservados
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.      1.INDICE
  54.  
  55.  
  56.      1.INDICE                                                                 2
  57.  
  58.  
  59.      2.GARANTIA                                                               3
  60.  
  61.  
  62.      3.DISTRIBUCION Y USO                                                     3
  63.  
  64.  
  65.      4.¿POR QUE?                                                              3
  66.  
  67.  
  68.      5.¿QUE HACE MDIFF-MPATCH?                                                3
  69.  
  70.  
  71.      6.EJEMPLOS                                                               3
  72.  
  73.  
  74.      7.DOS, OS/2, WINDOWS 95 Y WINDOWS NT                                     4
  75.  
  76.  
  77.      8.LIMITES Y ERRORES CONOCIDOS                                            4
  78.  
  79.  
  80.      9.MDIFF - MDIFF2 - MDIFFW                                                4
  81.  
  82.  
  83.      10.MPATCH - MPATCH2 - MPATCHW                                            5
  84.  
  85.  
  86.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         6
  87.  
  88.  
  89.      12.SUGERENCIAS                                                           6
  90.  
  91.  
  92.      13.LIBRERIAS PARA APLICAR PATCHES                                        6
  93.  
  94.  
  95.      14.REGISTRANDO MDIFF                                                     6
  96.  
  97.  
  98.      15.COMO CONTACTAR AL AUTOR                                               7
  99.  
  100.  
  101.      16.AGRADECIMIENTOS                                                       7
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                                                                               2
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.      2.GARANTIA
  115.      ESTE SOFTWARE Y LOS ARCHIVOS QUE LO ACOMPAÑAN SE VENDEN "COMO ESTAN" Y SIN
  116.      GARANTIA EN CUANTO A SU FUNCIONAMIENTO O COMERCIABILIDAD U OTRAS GARANTIAS
  117.      TANTO EXPLICITAS COMO IMPLICITAS.
  118.      La única garantía otorgada con este software es que ocupa espacio en su
  119.      disco. No se puede garantizar absolutamente que funcione perfectamente o
  120.      que sea la solución para su problema. Sin embargo, no es un virus y no
  121.      contiene (a menos que haya sido infectado o modificado después de la
  122.      compilación) troyanos, back-doors u otras basuras similares. En cada caso
  123.      el autor declina su responsabilidad directa o indirecta, por daños morales
  124.      o materiales que eventualmente puedan resultar de su uso.
  125.  
  126.      3.DISTRIBUCION Y USO
  127.      Este software pertenece a la categoría de programas Shareware: por lo que
  128.      se puede copiar y utilizar libremente por un período de prueba de 15 días.
  129.      Después de este período el usuario que desee continuar utilizándolo debe
  130.      registrar su copia enviando el importe de la registración al autor,
  131.      Maurizio Giunti.
  132.      Los usuarios que paguen el importe de la registración recibirán una "clave
  133.      de registración" que contenga su nombre (o el de su empresa/organización
  134.      para licencias a empresas).
  135.      Este software puede ser distribuído sin costo alguno, exceptuando el cargo
  136.      eventual por gastos de copiado o transporte/flete.
  137.      De todos modos, es imperativo que se distribuya el PAQUETE ORIGINAL sin
  138.      modificación ALGUNA.
  139.      Unica excepción: se puede distribuir el programa MPATCH.EXE, MPATCH2.EXE
  140.      y/o MPATCHW.EXE con uno o más archivos *.MDF creados con una copia
  141.      REGISTRADA de MDIFF. Además se puede distribuir cualquier archivo
  142.      ejecutable producido con MDF2EXE.EXE, MDF2EXE2.EXE y MDF2EXEW.EXE que
  143.      contengan únicamente patches MDF creados con una copia registrada de
  144.      MDIFF.
  145.      El autor de este programa no reclama derechos sobre los patches *.MDF.
  146.  
  147.      4.¿POR QUE?
  148.      Hace un tiempo tenía que distribuir una versión actualizada de un programa
  149.      mío: el paquete comprimido ocupaba más de 200 KB, y seguramente hubiera
  150.      sido más conveniente para todos actualizar el viejo ejecutable mediante
  151.      un patch. Me puse en búsqueda de un software que me permitiera crear y
  152.      distribuir un patch de mis programas para DOS y OS/2: para DOS encontré
  153.      algunos (pero ninguno me satisfizo por varios motivos); para OS/2 no
  154.      encontré ni uno! Por lo tanto, decidí hacer uno y... aquí está! 8-)
  155.  
  156.      5.¿QUE HACE MDIFF-MPATCH?
  157.      MDIFF crea un archivo binario con las diferencias entre dos archivos. Con
  158.      MPATCH y el archivo original se puede recrear el nuevo archivo partiendo
  159.      del archivo de diferencias. Qué hay de bueno en todo ésto? Simple:
  160.      suponiendo que el archivo de diferencias sea más pequeño que el nuevo
  161.      archivo, es más conveniente distribuir sólo ésto, en lugar del archivo
  162.      completo, sobre todo si la distribución se hace por modem.
  163.  
  164.      6.EJEMPLOS
  165.      Como un ejemplo puse en dos directorios de nombre VIEJO y NUEVO, el MDIFF
  166.      versión 1.45a (una versión alfa (de prueba) en progreso) y MDIFF 1.45
  167.      respectivamente:
  168.  
  169.      Directorio de VIEJO\*.EXE
  170.      MDIFF.EXE       46602  16/08/95   21.01
  171.  
  172.      Directorio de NUEVO\*.EXE
  173.      MDIFF.EXE       46602   21/08/95  00.45
  174.                                                                               3
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.      C:\>mdiff VIEJO\MDIFF.EXE NUEVO\MDIFF.EXE
  182.      MDIFF  V1.50 - MDF file generator (Dos)
  183.      (C) Copyright 1995/96 Maurizio Giunti
  184.  
  185.      Registered to: MAURIZIO GIUNTI
  186.  
  187.      VIEJO\MDIFF.EXE,NUEVO\MDIFF.EXE => MDIFF.MDF
  188.      Working...(100%)   MDF size: 1215 bytes   Rate: 2%
  189.      <Done!>
  190.  
  191.      Directorio de *.MDF
  192.      MDIFF.MDF        1215   7/10/95  13.43
  193.  
  194.      Ahora podemos aplicar el patch llamado MDIFF.MDF al archivo viejo para
  195.      reconstruir el nuevo:
  196.  
  197.      C:\>mpatch MDIFF.MDF VIEJO\MDIFF.EXE
  198.      MPATCH  V1.50 - MDF file applier (Dos)
  199.      (C) Copyright 1995/96 Maurizio Giunti
  200.  
  201.      MDF file produced by: MAURIZIO GIUNTI
  202.  
  203.      Working: 0% |###########| 100%
  204.      <Done!>
  205.  
  206.      I obtain the following file:
  207.  
  208.      Directorio de *.EXE
  209.      MDIFF.EXE       46602  21/08/95   0.41
  210.  
  211.      que es el EQUIVALENTE a nivel BINARIO del nuevo archivo.
  212.  
  213.      7.DOS, OS/2, WINDOWS 95 Y WINDOWS NT
  214.      MDIFF y MPATCH para DOS, OS/2 y Windows32 se obtienen a través de la
  215.      compilación del mismo fuente, por lo tanto, no existe ninguna diferencia
  216.      en la funcionalidad en el uso de los programas sobre los distintos
  217.      sistemas operativos. Además, los archivos *.MDF producidos con MDIFF para
  218.      DOS pueden ser utilizados con MPATCH para OS/2 o Windows32 y viceversa.
  219.  
  220.      8.LIMITES Y ERRORES CONOCIDOS
  221.      MDIFF no puede trabajar con archivos de más de 16 MB y no puede procesar
  222.      archivos más pequeños que 20 veces el largo de un chunk.
  223.      Además, MDIFF para OS/2, habiéndose obtenido a través de una compilación
  224.      directa del fuente de MDIFF para DOS, no está capacitado para trabajar
  225.      con los atributos extendidos (EA) y simplemente se limitará a ignorarlos.
  226.      Además, si se construye un patch usando MDIFF para DOS u OS/2, al
  227.      aplicarlo usando MPATCH para Windows32 se obtendrá una fecha y hora
  228.      incorrecta en el nuevo archivo. Lo mismo sucede si se construye un patch
  229.      con MDIFF para Windows32 y se lo aplica con MPATCH para DOS u OS/2. Esto
  230.      error surge de una implementación distinta de la función utime() en los
  231.      compiladores de Microsoft y Borland.
  232.  
  233.      9.MDIFF - MDIFF2 - MDIFFW
  234.      El programa MDIFF se ocupa de comparar dos archivos y de almacenar las
  235.      diferencias entre ellos en un tercer archivo que, generalmente, es mucho
  236.      más compacto. Esta es la sintaxis de la línea de comandos:
  237.  
  238.                                                                               4
  239.  
  240.  
  241.  
  242.  
  243.  
  244.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  245.                                      [<MDFfile>]
  246.  
  247.      <OldFile> es obviamente el nombre de la versión anterior del archivo a
  248.      comparar, mientras que <NewFile> es el nombre de la versión actual. Si es
  249.      necesario, se puede especificar el nombre del archivo de diferencias a
  250.      crear <MDFFile>; si no, MDIFF crea un archivo que tiene el mismo nombre
  251.      que <NewFile> pero con extensión ".MDF".
  252.      Para buscar las partes similares en los archivos MDIFF usa un string base
  253.      de largo predefinido de nombre chunk. El largo del chunk es de 16 bytes
  254.      por defecto, pero puede ser cambiado, en un rango 4-256, con el switch -C
  255.      seguido del largo deseado.
  256.      Cuando MDIFF pierde el sincronismo entre los dos archivos que está
  257.      comparando trata de resincronizarlos buscando el chunk que está elaborando
  258.      en el archivo viejo. Esa búsqueda se efectúa en un entorno del último
  259.      chunk encontrado, en el rango definido por el switch -R. Por defecto ese
  260.      rango es de 8 bloques de 512 bytes, pero puede variar entre 1 y 16.
  261.      Si esa búsqueda falla MDIFF trata de forzar ese sincronismo entre los dos
  262.      archivos buscando en un rango mayor, definido por 1/16 del tamaño del
  263.      archivo viejo. Esta segunda búsqueda puede ser deshabilitada o su rango
  264.      puede ser cambiado mediante el switch -F.
  265.      Especificando el switch -S, una vez terminada la operación, MDIFF arrojará
  266.      algunos datos acerca de la composición del archivo de diferencias.
  267.      También es posible, mediante el switch -Z, insertar en el archivo de
  268.      diferencias un breve comentario (con un máximo de 2 KB), que será
  269.      visualizado durante la aplicación del patch por parte de MPATCH. El
  270.      comentario se toma del dispositivo de entrada standard (stdin) y, por lo
  271.      tanto, puede ser tomado de un archivo usando el comando de redirección
  272.      "<".
  273.      Mediante el switch -P se puede proteger el patch con una clave de
  274.      acceso (<pwd>): aquel que no conozca la clave no podrá aplicar el patch.
  275.      Por favor tenga en cuenta que el campo de clave hace distinción entre
  276.      mayúsculas y minúsculas.
  277.  
  278.      10.MPATCH - MPATCH2 - MPATCHW
  279.      Con el archivo anterior y el archivo de diferencias .MDF se puede
  280.      reconstruir el archivo nuevo usando MPATCH. Esta es la sintaxis de la
  281.      línea de comandos:
  282.  
  283.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  284.  
  285.      El único parámetro obligatorio es el nombre del archivo de diferencias
  286.      <MDFFile>, ya que el mismo contiene el nombre de los otros dos archivos,
  287.      pero es posible modificar esa imposición simplemente especificando los
  288.      nombres deseados en el orden correspondiente. MPATCH acepta sólo el
  289.      switch -P que permite especificar una eventual clave de acceso
  290.      necesaria para aplicar el patch.
  291.      En caso de error MPATCH retorna un errorlevel que debe ser interpretado
  292.      según la siguiente tabla:
  293.      0        "¡OK!"
  294.      1        "¡Memoria insuficiente!"
  295.      2        "¡No se puede abrir el archivo MDF!"
  296.      3        "¡Archivo MDF inválido!"
  297.      4        "¡Las versión del archivo MDF no coincide!"
  298.      5        "¡NO REGISTRADO!"
  299.      6        "¡Archivo VIEJO corrupto o incorrecto!"
  300.      7        "¡No se puede abrir el archivo VIEJO!"
  301.      9        "¡No se puede crear el archivo NUEVO!"
  302.      10       "¡Falla general: archivo NUEVO corrupto!"
  303.      11       "¡El archivo VIEJO y el NUEVO no pueden ser el mismo!"
  304.      12       "¡El archivo nuevo ya fue patcheado!"
  305.      13       "¡Clave de acceso incorrecta!"
  306.  
  307.  
  308.                                                                               5
  309.  
  310.  
  311.  
  312.  
  313.  
  314.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW
  315.      MDF2EXE es un simple programa que se ocupa de almacenar uno o más (hasta
  316.      127) archivos de patch MDF en un archivo ejecutable (DOS, OS/2 o
  317.      Windows32).
  318.      Este tipo de ejecutable se llama patch autoinstalable.
  319.      La sintaxis del programa MDF2EXE:
  320.  
  321.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  322.  
  323.      Los distintos <mdf_file x> pueden contener "wildcards" (*,?); en este
  324.      caso MDF2EXE buscará automáticamente los archivos a insertar.
  325.      El archivo ejecutable creado (que DEBE tener extensión .EXE) podrá ser
  326.      ejecutado sin ningún parámetro en la línea de comandos y buscará
  327.      automáticamente los archivos a actualizar. Opcionalmente se puede
  328.      utilizar el switch -P para especificar la clave de acceso, o los switches
  329.      -V o -L para visualizar la lista de los patches contenidos en el archivo.
  330.      Advertencia: no se deben comprimir los patches autoinstalables con PKLite,
  331.      LZexe u otros programas de compresión/encriptación similares; de otro
  332.      modo, dejarán de funcionar.
  333.  
  334.      12.SUGERENCIAS
  335.      El método óptimo para construir un archivo de diferencias sería el de
  336.      buscar en todo el archivo viejo los chunks que componen el nuevo archivo;
  337.      obviamente, ese método sería de una lentitud exasperante.
  338.      El algoritmo en que se basa MDIFF representa un compromiso entre resultado
  339.      y velocidad de ejecución, por eso conviene regular los parámetros de
  340.      funcionamiento de MDIFF mediante los switches correspondientes. Veamos
  341.      cómo actuar en algunas situaciones típicas:
  342.      1.Archivos con poquísimas modificaciones: es bueno utilizar un chunk muy
  343.        amplio (32, 64 o más) para reducir al máximo el tamaño del archivo de
  344.        diferencias, sobre todo si se está trabajando con archivos de texto o de
  345.        bases de datos.
  346.      2.Archivos de texto: cada tanto un chunk de largo 32 es el más indicado; es
  347.        conveniente probar de disminuir o eliminar el sincronismo forzado
  348.        mediante el switch -F.
  349.      3.Archivos ejecutables muy grandes: a menudo se obtienen resultados
  350.        mejores agrandando el rango de búsqueda del sincronismo mediante el
  351.        switch -R.
  352.      Un último consejo: no esperen milagros de MDIFF. Si los dos archivos
  353.      comparados son muy distintos el archivo de patch resultará muy grande. En
  354.      estos casos hay poco que hacer, y hay que resignarse a distribuir el nuevo
  355.      archivo entero. MDIFF es realmente útil sólo si el número de
  356.      modificaciones hechas a los archivos no es demasiado grande.
  357.  
  358.  
  359.  
  360.      13.LIBRERIAS PARA APLICAR PATCHES
  361.      Incluído en este paquete encontrará un conjunto de librerías para crear
  362.      sus propios programas para aplicar patches. Estas librerías NO PUEDEN
  363.      aplicar patches MDF creados con una copia NO REGISTRADA de MDIFF.
  364.      Esto no significa que no sean completamente funcionales. Significa que
  365.      las librerías sólo pueden aplicar patches producidos por una copia
  366.      registrada de MDIFF.
  367.  
  368.  
  369.  
  370.      14.COMO REGISTRARSE
  371.      Si registra MDIFF obtendrá una CLAVE DE REGISTRACION que contenga su
  372.      nombre (o el de su (o el de su empresa/organización para licencias a
  373.      empresas). Cuando produzca un patch con un MDIFF registrado, se grabará su
  374.      nombre en el patch y cuando MPATCH aplique los mismos mostrará su nombre.
  375.      Además, todo usuario registrado tiene autorización para distribuir
  376.      libremente MPATCH.EXE, MPATCH2.EXE y MPATCHW.EXE con cualquier archivo MDF
  377.      que haya creado. También se pueden distribuir libremente los patches
  378.      autoinstalables creados por usuarios registrados.
  379.      ¡No se requiere el pago de royalties ni de cargos extras!
  380.      Incluído en el paquete de MDIFF encontrará un programa de registración
  381.      para Windows de nombre REGISTER.EXE. Por favor ejecútelo en el entorno
  382.      Windows.
  383.                                                                               6
  384.  
  385.  
  386.  
  387.  
  388.  
  389.      REGISTER.EXE es una pequeña aplicación para Windows escrita por Grzegorz
  390.      (Greg) Kochaniak, que provee toda la información necesaria para comprar
  391.      MDIFF y que permite mandarla directamente al servicio Kagi Shareware por
  392.      correo postal, correo electrónico (e-mail) o fax. Si no usa Windows, por
  393.      favor contáctese conmigo.
  394.      Por cualquier información acerca de Kagi Shareware por favor lea el
  395.      archivo KAGI.TXT.
  396.  
  397.      15.COMO CONTACTAR AL AUTOR
  398.      Por cualquier problema o pregunta puede contactarme en las siguientes
  399.      direcciones:
  400.  
  401.      correo postal:
  402.                      Maurizio Giunti
  403.                      Via G.B. Foggini, 24
  404.                      50142 Firenze (FI)
  405.                      ITALY
  406.  
  407.      e-mail:
  408.                      Fidonet:      2:332/102.3
  409.                      Internet:     giunti@kagi.com
  410.                                    giunti@abeline.it
  411.                                    giunti@statsun.ds.unifi.it
  412.  
  413.      16.AGRADECIMIENTOS
  414.      Querría agradecer brevemente a todos aquellos que me han ayudado en el
  415.      desarrollo de este software y de su documentación, y a aquellos que se
  416.      ofrecieron con coraje como beta-testers. En orden alfabético:
  417.  
  418.                              Mauricio Mello de Andreade
  419.  
  420.                                    Andrea Baitelli
  421.  
  422.                                     Silvia Borri
  423.  
  424.                                  Juan Jose Comellas
  425.  
  426.                                     Filippo Dini
  427.  
  428.                                  Fabrizio Fioravanti
  429.  
  430.                                  Cristiano Guidoccio
  431.  
  432.                                 Giovanni Lopes Pegna
  433.  
  434.                                   Marco Maccaferri
  435.  
  436.                                   Marco Menichelli
  437.  
  438.                                    Giuseppe Scarpi
  439.  
  440.                                    Toni Tatafiore
  441.  
  442.                                     Duncan Wilcox
  443.  
  444.  
  445.  
  446.                                                                               7
  447.  
  448.